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1.0 INTRODUCTION 



i.o itaiEoaumi]!* 



The $£$ TeXT F3*fl«tter' (TXTFQRM) has capabilities for 
conventional formatting features as well as box and table drawing 
and other complex functions* Tliese capabilities* together with 
automatic line jus ti f I cat I on. assure the user a properly 
formatted document* 

This document itself was Produced using TXTFQRM* 



60460290 01 



2-1 
CDC - SOFTWARE ENGINEERING SERVICES 

13 DEC 83 
TXTFORH 1.5 Reference Manual REVt I 

2.0 FEATURES Qf THE FORMATTER 



2.0 £EAIU&£$JB£-ia£-E3BaAIIE& 



The following items describe in genera! terns some of the 
features available wl th the formatter. Detailed descriptions of 
these and other features can be found throughout the remainder of 
the document. 



LaaauasiS 



The language follows a free form concept for the input 
text data. Text or formatting codes can appear in any 
character Position of a record with the following 
exceptions! 

The formatting code string must be preceded toy an 
ASCII character chosen as a delimiter C by default 
the rer^r'sB slant* \ ) » in character position 1 
of a record. This record will contain only a 
formatting code string. A formatting code string 
consists a* either a concatenated string of single 
letter formatting codes or a single word 
formatting code such as \HARGIN. The string also 
includes whatever parameters may be associated 
with a code. Any alpha character of a formatting 
code mav he either upper or lower case. 

Example* VslT2(eoU or \SPaCE2<eol). 



E&L!££JLLnfl-.£L&ii£S 



Formatting codes control the format of the document and 
the manipulation of text within that format. Codes 
appear as words that describe the function such as 
UENGTH and X^OLIO and others are alpha characters that 
represent a function such as \T for tabbing and XI for 
Indent. Some codes can be parameterized for greater 



f lexibil ity.! 



Input to th*« formatter is a file containing variable 
length records. The records contain full ASCII set 
characters represented in NOS 6/12 Display code. Each 
record is terminated by a zero byte record CeoU. The 
program prepares a formatted document file utilizing 
the full eight-hit ASCII character set. 
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2.0 FEATURES OF THE FORMATTER 



££fl&JEfi£lBl£ 



A page is composed of designation text* such as titles 
and folio fines* and all other formatted text* which 
forms the text body.i The page dimensions for each of 
these text types are separately defined by formatting 
codes. 



Lias.lEaslas 



Formatted lines are orlnted single spaced as a default 
selection. Spacing can foe changed dynamically with the 
\SPACE formatting code. 



Lias.iiistilisitiua 



The program Justifies lines of formatted text by 
inserting blanks and manipulating whole words to fill 
the line length* producing an even right margin. The 
process alternates from left to right and right to left 
on lines of text to eliminate blocks of blank space* 
Non-justified text can be requested with a formattlna 
code. The fine length for non-justified text Is filled 
with as many whole words as possible separated by one 
b lank. 



litl£&_£Q£i-EalJL2£ 



6 TITLE lines can he selected with a formatting code. 
Another formatting code prepares a folio line at the 
bottom of the page.' 



y&asiiaas 



Seyen heading levels are available that provide 
automatic section numbering. Seven additional levels 
can be selected that are not numbered. The style of 
the Headings can he varied with a formatting code. 

SLS&tiflQ.MUaJbfiXiQA.AQi.£attiai.LLsli&fl 

Tbe formatter provides the capability of generating 
section numbers automatically* The user can also 
request only selected sections to be printed. 

£u&&i£l£utliJLi&£& 

Supplemental lists can be produced for use as tables of 
contents* figures and other cross-reference lists using 
various formatting codes. 
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3.0 FORMATTING COOES 



3.0 EQ&aAimfi-CMES 

3.1.1 TEXT FORHATTING CO0*S 
U 



&W>«mJL& 



Text subsequent to the \A code mHI be printed as it 
appears in each inout record. The dimensions of the 
input record are described by the XRECORD formatting 
code. The text of each record is not 'justified* 
leading blanks are not removed and spacing blanks are 
not added. Text records are printed , as-is f * starting 
at the current margin setting* untii the occurrence of 
the next formatting code. Truncation occurs if the 
text of the input record exceeds the iength of the 
output record as described by the XLENGTH code. 



X8xx*yy* ... zz 

The box code draws a horizontal line from character 
position xx to *£• Vertical lines will be drawn from 
character positions xx* yy* • • »zz. If the code XB is 
used with no parameters* a box will be drawn using the 
values defined by the previous \8 code. Terminated by 
the \E code.! 

\BB*xx* yy» ...z* 

The enlarge box code adds vertical lines in character 
positions xx*yv* ..Vzs to those already begun by the \B 
code. Also draws a horizontal line between the outside 
columns of this ne* box. Maximum of 17 vertical lines 
may be active. Terminated by the XE code. 17 
additional vertical lines are available with the \V and 
\VV codes. Terminated by the \E formatting code. 

\C 

The text following the \C code is centered within the 
line length defined by the XLENGTH code. The text to 
be centered should occur immediately subsequent to the 
record containing the XC code since other intervening 
codes nullify the effect of the center code. To center 
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3.0 FQRHATTINfi COOES 

3.1.1 T€XT FORMATTING CO0SS 

more than ois line of formatted text* tl^e \C code must 
precede each text record in the Input file. Extraneous 
Inter-word blanks are not removed from text to be 
centered. 

\E 

&ad.£ax 

The VE code draws the bottom horizontal line of the 
current box and turns off the vertical lines* 

asaJuQ-Eaaitaais 

The text following this code becomes a footnote and is 

placed at the bottom of the current page. The symbol 
that calls out the footnote Is placed by the user in 
the regular text stream and in the footnote text. See 
the Examples Section. Formatting codes occurring 
between the \F code and the M code (end footnote} will 
affect only the footnote text. A max I mum of 10 lines 
per page is allowed for footnote text. 

\Gaa*bh»«« .yy» z* 

jdatizaatai-kias 

Draws a line on the current formatted text line between 
any given character positions (aa to bb» yy to zzl. 
Character positions must be specified in numerically 
ascending pairs. 

\Hnn 

asaiiaa-Lfixsi-Ssiaatiaa 

nn is a level number X through 7 or 11 through 17 
corresponding to hierarchical levels of section and 
paragraph control. See the Heading Level Selection 
Table. Text following this code is formatted according 
to the heading style selected and terminates at the 
next formatting code or end of sentence. Heading text 
Is not justified* leading blanks are not removed and 
spacing blanks are not added. The number of characters 
in the heading text including blanks should not exceed 
the value defined bv CVLENGTH - \HARGIN). The range of 
level numbers 1-7 will cause the program to generate 
section levfel numbers automatically and prefix them to 
the subseguent text. 5 Levels 11-17 provide the same 
format as levels 1-7 but do not provide section 
numbers. See the section on Automatic Section 
Numbering. nn is also the level number referenced by 
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3.0 FORMATTING COOES 

3.1.1 TEXT FORMATTING CODES 

the MIST code In preparing supplemental lists that 
Include heading text. 

\Inn 

ladftfii 

The XI code causes the subsequent text to be Indented 
nn spaces from the left margin in the formatted line* 

starting a new line. If nn Is not specified* the last 

declared value a** *n or the default value of nn <3) 

will be used. nn equal to will start a new line at 
the left margin. 

The text following the \4 code begins at the current 
position In the formatted line according to other codes 
In effect. Hanging Indentation begins at the next new 
formatted line. The new line nr%d subsequent lines of 
formatted text will he Indented nn positions from the 
left margin as defined bv the VMARGIM code. The XJ 
code is terminated by the next code that affects 
Indentation.? If nr\ is not specified, the last declared 
value of nn or the default value of nnCO) will be used. 

XKnn 

The XK code affects subsequent text until the 
occurrence of the release keep code (XR). An attempt 
Is made to keep the text so bracketed from being split 
between pages as it Is formatted. If the value nn 
(approximate number of lines to keep) exceeds the 
number of lines remaining on the page* a new page Is 
started before printing the kept text. If nn is not 
specified, one line is assumed. 

XL 

The XL code draws a horizontal line between the outside 
columns of the current box. 

XH 

Hacaia-iats 

An asterisk (*) is placed In the current position in 

the formatted text and a pointer ( less than CO) is 

placed In the right margin of the line. 
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3.0 FORMATTING CODES 

3.1.1 TEXT FORMATTING CODES 

\Nnnn 

A fie** page Is started before printing subsequent text* 
The \ TITLE block will" be printed before any subsequent 
text. If nnn is not specified* the new page number 
will be one greater than the previous page. If 
specified. the value o* nnn will be used as the page 
number of the new page. If the page number is being 
automatically generated by sections* the nnn oarameter 
will be ignored* Refer to the section on Automatic 



Section Numbering. 



Mull 



The formatting code delimiter* when used aione* can be 
used to terminate codes when no other selection is 
appropri ate*< 



The \D code will cause the next two text characters 
appearing In the source text to be overprinted in the 
formatted text* The second character is the primary 
character and will print over the first* The two 
characters can be dissimilar* Overprinting to achieve 
a boldface aooearance for a string of characters can be 
obtained with the \80L^ formatting code. 
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3.0 FORMATTING COOES 

3.1.1 TSXT FORMATTING COOES 

\P 

The \P foriatting csde provides the capability of 
formatting text- in a paragraph style. The first line 
of the formatted t»xt Mill be indented and spaced 
according to the options in the Heading Level Selection 
Table* Subsequent formatted lines will begin at the 
current left margin. Records of text in the input file 
will continue to he formatted in paragraph mode until 
the occurrence of the next formatting code affecting 
format. 



Ea£~M&££i£al_Li&&s 

All vertical lines in effect by W and \VV codes are 

terminated. 

\R 

E£tfiJ&£-&££& 

Identifies the end of the text to be keot together. 

\Snn 

nn blank lines are printed. If nn is 0* a new line is 
started whenever the next text is to be printed. If nn 
is Of the new line will be started according to the 
line spacing! in effect by the current VSPACE code. If 
nn is not 0. the number of blank lines printed are 
single-spaced. If nn is not defined* the last value 
assigned is used* or the default value of Is used if 
nn was not previously defined. 

VTnn 
X.Tnn 



lab 



The VTnn cades and the \SETTA8 code together provide 
the capability of starting text in defined character 
positions. These character positions are defined and 
given a reference number by the \S£TTA8 code. 

The nn parameter of the \T and VSETTAB code is the 
reference number of the tab position. The user assigns 
a reference number of 1—15 to parameter nn of the 
\SETTAB code and specifies what character position this 
number should refer to. For example* if the code 
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3.0 FORMATTING CODfS 

3.1.1 TEXT FORMATTING CODES 



\S€TTABS30#74Q is defined* tab position number 5 Mill 
start In character position 30 of the formatted line. 
Tab number 7 will start in character position 40. 

Tenet that is to start In character position 30 Mould be 
preceded by a \T5 code. \T7 would begin subsequent 
text in character oosltion 40. Tabbed text is placed 
in the current formatted line and does not start a neM 
line. 

If the \T code is used without a reference number* the 
text Mill staM: in the next character position defined 

as a tab stop greater than the current position. 

The \.Tnn code provides for line padding using a 
period. Blanks soaces are filled Mith periods between 
the last character placed in the line and the character 
position referenced by the number nn* 

The character positions of tab stops are defined 
relative to character position It not the current 
\MARGIN setting. 

If no \SETTAB code has been defined* the default 
character positions of the 15 tab positions available 
are in increments of 5* beginning with \T1 equal to 5 
through \T15 equal to ?5. 



The Ml code Is used to allow a mixture of tabbed text 
and untabbed justified text on the sane line. Untab 
can be used in conjunction Mith margin and line length 
changes to allow for columnar text in tables. See 
Examples Section. 

Wxxtyy* •* • zz 

Vertical lines Mill be drawn from the character 
positions x x»yy* •• »z*. Terminated by the \Q code. A 
maximum of 17 vertical lines defined by the W or \VV 
code may be active. I This does not Include the 17 
vertical lines that may also be active using the box 
codes* \8 aid \Bb. If another \V code appears before a 
\Q code* the previous \V code Mill be terminated* but 
the current line m! 11 contain both sets of vertical 
I ines. 
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3.0 FORMATTING COD^S 

3.1.1 TEXT FORMATTING COOES 

WVxx* yy* • *«zz 

AM_M&££J.£ai_Lia££ 

Vertical lines nil I be drawn from character positions 
xx*yy* *• »zz# * in addition to any other vertical lines in 
effect. Terminated by the \Q code. 

\Xn 

The exception code provides a mzans of entering text 
that Is not a heading into a supplemental list. The n 
parameter corresponds to the n parameter of the MIST 
code. Each MIST code identifies the level numbers of 
text to he Included in that supplemental list, 
exception text I 'eve I numbers can be from 1 to 17. The 
user assigns this number according to the inclusion 
desired in a list. 

All exception text preceded by an \X3 code* for 
example* Mould appear in any list requested by a MIST 
code that included a 3 In the parameter string (MIST3* 
MISTl*3*A etc.). Since heading text is also Included 
in supplemental lists according to level number* the 
MISTS in the above examples would produce lists that 
also included VH3 heading text. Lists of exception 
text can be developed that do not include heading text 
by assigning a level number that is not being used by 
headings • 

Exception text levels 3-9 and 13 - 17 nr e indented in 
a supplemental list* levels i*£*ll and 12 are not* 
Exception text is also included in the current position 
in the text stream according to the other formatting 
directives i'n effect* 

The text following the \Xn code* up to the next 
formatting code or end of sentence* will be included in 
a list. Exception text is not justified* leading 
blanks are not removed and spacing blanks are not 



added 



\I 



Specifies the end of footnote text. 
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3.0 FORMATTING CODES 

3.1*2 DOCUMENT FORMATTING COOES 

3.1.2 DOCUMENT FQRNATTINS CODES 

\CHAHGE# ccccccc 

The \CHANGE code indicates that the source text file is 
composed of records that contain a field to be used as 
a source identifier. This field can be a max! nun of 14 
character oosltions In length. The formatter assumes 
the first 7 oosltions as the source identifier field 
and ignores the trailing 7 characters which can be used 
for numerical sequencing* 

The source identifier in the field can be 1 to 7 
characters left adjusted with blank fili. 
The ccccccc parameter is the base Identifier against 
which the first ? characters of the identifier field in 
each record is comoared. 

Formatted outout lines containing test from records 
ahosa source identifier is different fron the base 
identifier (ccccccc) Mi II be marked by a revision bar 
{vertical bar). This bar apoears 3 character oosltions 
to the right of the right margin as defined by the 
\F0R?1AT or \LFMGTH code* whichever is the greater. 
The placement of the source identifier field in each 
text record must begin in the character position which 
follows the text limit described by the \RECQR9 code. 
Il2sx.8£fiLsi..i.l&£'£0[RQ.fiaiifi..Byst..*2&fiflC as i&s titit 

iJ2s-sayL£s-l^satl£isr--IisidA--Ilis-£«fifl£4-fiaotJiQiafl-tiia 

For example* assume the 14 character source identifier 
field begins in character position 100 • A \ftECOR01#99 
code at tke beginning of the file properly identifies 
the text portion of the source records and the location 
of the source identifier field. Given a maximum record 
length of 136 characters* and the need to accomodate 
the 14 character Identifier field* the maximum text 
portion of the record is 121 characters. 
The \CHANGE code appearing in the text file with no 
Identifiers (NCHANGE! will turn off the subsequent 
generation of revision bars. 

For Information on the automatic generation of a 
formatted document with revision bars* reference 
Section 6.1 on sequenced files and revised documents. 

VCQDES 
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3.0 FORMATTING CODES 

3.1. E OQCUHSNT FORMATTING SHOES 



\CODES causes * listing to be printed at the end of the 
document uhich contains information about formatting 
codes used* default settings in effect and errors 
encountered in formatting the document. If \ CODES is 
not usedt no codas/error listing will appear. 

\C0HMENT 

The VCQHHENT' code allocs text in the source file to be 
used for file documentation purposes. All records 
occurring between the \C0MMEMT code record and the next 
record containing a formatting code* Hill be ignored by 



the formatter*' 



\0ATI 



The date* specified by the line of text following the 
date codet Is Mght justified on the third line of the 
title block. 



XF01I0 

£ali2_Lias. 

The folio is the bottom line printed on each page. The 
text following the \F0LI0, code will appear right 
adjusted to the right margin of the folio line. This 
text villi appear on every page until redefined. The 
\F0LI0 code appearing without subsequent text Mill 
effectively remove the current \F0LI0 text. The \FGLIQ 
text is terminated by the next formatting code. Since 
the \FQLI0 line Is limited to the last line of the 
Paget text exceeding the limit of the line as defined 
by the \F1RHAT code be truncated. Underlining is not 
permitted, ^oilo text is not justifiedt leading blanks 
are not relayed* and spacing blanks are not added. 

XFORMATaat bbtnn 

£aLaa£_af.-££3£ 

XFORMAT all mis the user to alter the page dimensions 
for designation text. Refer to the description of Page 
Format in the Conventions and Definitions Section. 
\F0RHAT defines the left and right margins for \TITLE 
block text* VFCJLIO text* supplemental lists* and 
sequence nutiber placement. \FQRMAT also describes the 
depth of tha fom in lines from the top of form. 
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3.0 FORMATTING COOES 

3.1.2 DOCUMENT FORMATTING COOSS 



The value aa is the character position that will be 
used as the left margin for the above mentioned text 
types. The default value is 7. 

The value bb establishes the right margin for the above 
text types. THb effective line length is (bb - aa). 
The default value Is 75. 

The value n?v defines the number of lines per page from 
the top of form*' The placement of the \F0LI0 line and 
the number of lines available for the text body for 
each page wi 1 1 he adjusted by the program* depending on 
the number of lines in the YTITLE and sub-title block 
for the current page. The default value is 60. 

Only one XF3RMAT code Hill be recognised and must occur 
before any formatting code that Introduces text. The 
definition of XMARGIN and XLENGTH are unaffected by the 



XFQRMAT statement.; 



XHEAOc 



This code is used to select one of three standard 
heading sets described In the Heading level Selection 
Table, c can be either A*B» or C. Each set defines 
the format of all headings and paragraphs defined by 
the XHn and X* formatting codes. See Heading Level 
Selection Table. 

XJUST 

The default mode of the formatter is fine justification 
to the right margin. Ttie XJUST formatting code returns 
the program to this mode if the XNOJUST code has been 
in effect* Justification has no effect on the last 
line of a oaragraoh or on XTITLE* XFOLIO* heading* 
exception* centered and *as-ls f text. If Justification 
Is in affect* the program may adjust the space between 
any two words that are separated by one or more blanks. 

XlENGTHxxx 

Lia£-i£Qfifci3 

The XLENGTH code establishes the right margin of a line 

of text in the text body by specifying the last 

character position of the formatted line. See the 

definition of Page Format in the Conventions and 

Definitions Section. xxx indicates the character 
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3.0 FORMATTING COOES 

3.1.2 DOCUMENT FORMATTING : ;r 1DES 

position relative to character position zero* not the 
current left margin setting* The default last 
character position Is 75. The maximum value of xxx is 
100* If xxx Is not defined* the default value of 7f 
Mill he used* 

\LI5Tn* n* . .nn 

The MIST code orovl 4%$ a means of requesting 
supplemental lists £n addition to the formatted 
document. In entry In a list is defined as heading 
text or exception text* 

Heading text is Introduced into the document by the 
heading level selection codes* \Hnn. Exception text is 
associated with the Xn code. 

The n#n*..no Parameters of the MIST code are level 
numbers that correspond directly to those used with the 
\Hnn and \Xn codes. 

Fach occurrence of a MIST code wi I I produce a separate 
list. Each supoJemental list produced Hill contain the 
text associated with the level numbers indicated with 
the MIST coda. £$r example! 

If the code MISTl*3*4*ll appears In the text file* the 
program Hill generate a supplemental list containing 
the text associated with all \H1# \H3# VH4* \H11 and 
all \X1* \X3» \X^ codes encountered in the file. If 
separate lists of each level of text are needed* The 
MIST codes used would bet 

\LIST1 

UIST3 

\L1ST4 

MXST11 

Level 1 heading and exception text would appear in a 
separate list from level 3 headings and exception text. 

If MIST Is used with no parameters* the default 
condition prevails and a list nil I be produced 
containing the text associated with all \Hnn codes 
appearing Irr the text file. 

The order of entries In a I i st Hill be sequential as 
they occur in the text file. The order in which lists 
are produced will be the sequence in which the MIST 
codes occur.i 
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3.1.2 DOCUMENT FORMATTING CQOSS 

The page number ^here each entry occurred in the 
formatted document Mill be printed at the right margin 
of the line in the list. 

Indentation of entries in a list is as foil cms* 

Level 1 Proceeded by blank line* not indented 

Level Z Single soaced* not indented 

Level 3 Single soace* indented 2 spaces 

Level 4-7 Single spaced* indented 4 spaces 

Levels 11-17 correspond to levels 1-7 regarding spacing 
and indentation. The text line immediately following a 
\LIST code will he used as a title for that list. The 
title text terminates at the next formatting code or 
end of sentence. The text for the \LIST title does not 
have leading blanks removed and will appear centered on 
the page. Each supo I omental list will start on a new 
page. The \TITL€* sub-title and \FOLIO text lines will 
not appear. The suppI omental lists are printed 
subsequent to the formatted document. 

All \LIST codes must precede any \Hnn and \Xn codes in 
the text file. 

X^ARGINnn 

L£££-&a£sia-Ea£iJ;iaa 

r\n defines the number of blank characters in the left 
margin of a fine in the text body. See the definition 
of Page Format in the Conventions and Definitions 
Section. Tfce effective flowing text line is delimited 
bv the first character position determined by \HARGXN 
and the last character position of a line defined by 
the VLENGTH code. The default VMARGIN Is 10. If 
\ MARGIN aooears without a parameter* the default value 
will be used. 

VNCMUST 

This code turns off line justification for the 
remainder of the document or until a \JUST code is 
encountered to reinstate line Justification. 

\NQSEQ 

\M0SE0 requests the formatter to prepare the formatted 
document without sequence numbers appended to each 
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3,0 FtmiUTTIHG CODES 

3.1.2 DOCUMENT FORMATTING :O0FS 



line, \NOSE-0 is the default mode of the formatter. 
The VNQSEQ code terminates sequencing initiated fey the 
\SEO code. 

\RECQRDxxx»zzz 

\RECQRO defines that portion of a max! mum 136 character 
Input record that Hill he regarded as text, xxx is the 
first character position. zn.z is the Jast character 
position. If xxx appears alone* it will be regarded as 
defining the text portion of the record to he character 
positions I through xxx. The maximum value of xxx or 
zzz is 136. The VRECHRD code must appear as the first 
record in the source file if it is used. The default 
character positions are 1 (xxx) and 136 <zzz). 

VSECTIONnnnt nnn» •• • .onn 

The VSSCTIOM code allows the user to request only 
specified sections to he listed. nnn refers to the 
major section number 1 ' assigned to the text associated 
with an \Hl heading code. Only one \ SECTION code Hill 
be recognized hy the program and it must appear before 
the occurrence of any \H1 code. The maximum number of 
sections that can he requested is 32. The value of nnn 
is section numbers 1 through 999, Refer to the 
Convention section ?or Section Numbering and Partial 
L I sting. 

\SEO 

The \SEQ formatting code sequences the formatted 
document with line numbers. The number of lines to be 
sequenced oer s»age is that number calculated from th*» 
depth parameter of the \F0RMAT code. The sequence 
numbers start with 1 for each page. \TITtE and VFOLIQ 
I ines are not sequenced. The sequence number appears 
right adjusted to the character position that is 5 
greater than the right margin character position 
defined by UEN3TH or VHARGINt whichever is the 
greater. The \H0SEQ code returns the formatter to 
non-sequenced document mode which is the default mode. 

\S£TAPP 
c-xxxxxxx 
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3.1.2 OQCUNENT FORMATTING ZmES 



£s£_&£££aji,U 

Appendices can be described using the VSETAPP code. 
The VSETAPP' code Is foil cued by a line of text in the 
form c— xxxvxx where c is an appendix Identifier 
(letter* number or special character other than the 
current formatting code dellmi ter) » and xxxxxxx is the 
title (name) of the appendix. 

Appendices are created like sections using the \H1-\H7 
heading codes. The appendix identifier will be 
prefixed to the automatically generated section and 

page numbers* 

The VSETSEC cole can be used to set the number at which 
the appendix section Is to begin. If VSETSEC is not 
used prior to the VSETAPP code* the appendix section 
number will increment from the section number currently 
in effect. 

The title (name) of the appendix will appear as an 
entry in the supplemental list ( if selected) prior ti 
the entries o* the apoendix section and page numbers* 

To change the current appendix identifier and/or title* 
re-define the VSSTA^ code prior to the heading code 
CVHi) where the change is to appear. 

\SETE*c 

£££_£££13££iQ£-£a4£j&lilJ.££L 

This code can be used to change the formatting codes 
delimiter from the default character* V * to (cl* any 
full ASCII set graphic. Care should be taken in 
selection of the character to be used* since the 
appearance of the delimiter in character position 1 of 
any record will cause the remainder of that record to 
be treated as formatting codes. This can be confusing 
if a frequently used alphanumeric character is chosen. 
If (c) Is ouitted and the code appears as VSETE* or 
VSETE * the default delimiter character (VI wiil be 
restored. 

vsersecnnn 

£££.££££laaJtiU!!l&££. 

VSETSSC supplies a section number (nnnl that is to be 
used by the automatic section numbering feature as a 
new base section number from which subsequent 
sequential section numbers are generated, nnn allows a 
section number frou 1-999. 
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3.1.2 DOCUMENT FORMATTING COQFS 

\SETSEC can fee used anywhere in the source file and its 

effect Kill be as foil oust 

If* for example* the formatter is generating text 

«i thin Section 4*0 and a XSETSECnnn code is 

encountered* the next new section number generated Mill 

be nnn.0 rattier than 5.0. 

The effect of the YSETSEC code is delayed until the 

start of the next section. Each succeeding section 

will be numbered Incrementally from nnn.Q for the rest 

of the document or until the occurrence of another 

XSETSEC coda. 

If automatic section numbering is not in effect {no 

\Hl-\H? codes nre being used) XSETSEC is ignored. 

\S£TTA8nnxx*nnyy.. *r%nzz 

The character positions on a line of the formatted 
document can be declared as tab positions by the 
VSETTAS formatting codes. A maximum of 15 tab 
positions is allowed. Character positions are numbered 
from character oositlon It not the current \liARGIN 
setting. 

In the \SETTAft code* the nn parameter refers to a 
reference number the user assigns to a character 
position that is to be a tab stop. This is the number 
that is then used by the \Tnn formatting codes when the 
actual tabbing a* subsequent text Is to occur. The 
«x»yy.*zz io the \5ETTA8 code refers to the character 
position In which the text is to start for that tab 
setting. ^or example* if \SETTAB120*230 is defined* 
the code VT1 would cause subsequent text to begin in 
character oosltlon 20 of the current line. Text would 
begin In position 35 following a \T2 code. Character 
positions must be designated by 2 digits* such as 
29*03*09. 

Tab settings remain in effect until individually 
redefined. In the above example* the tab position 
referenced by number 2 could be changed to character 
position *»D bv defining a XSETTAB240 code. This would 
not disturb the setting of the tab position referenced 
by the number I. 

Tabbed text can then be manipulated by changing 
character positions In the \SETTAB codes without having 
to disturb the Tnn codes distributed throughout the 
text. If \SETTAB appears with no parameters* the 
'default values will be assigned to the 15 tab 
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3.1.3 OQCUHCNT FORMATTING :305S 



positions. The defaulted values are 5 for position one 
and an increment of 5 for each succeeding position* 



\SPAC£n 



The default mode of the formatter is single spacing. 
The space code all3ws the inter-line spacing to be set 
at one (n»ll or two <n*3) lines* If n is not 
specified* single soaclng will be set* 

\TITL£n 

i£l££i.Xiil£ 

There ar e 6 title lines available In the title block 
that begins each new page* n ( 1-6 ) Is a positional 
reference to the placement of the subsequent text of 
the title Itself. The text of each title selected will 
appear in the title block on each page of the document* 
To change the text of a title iine in the block* 
re-define that title and supply a new text line. If 
XTITLEn appears without subsequent text* the title line 
n mIH be removed fro* the title block* Title text is 
not justified* leading blanks are not removed and 
spacing blanks are not added. The number of characters 
In a title must be limited to the definition of title 
line length described by the \FQRHAT code. If n is not 
specified* 1 Hill be used* 

\T0DAY 

This code Is used Instead of the code VDATE whenever 
the current date is desired. The current date will 
appear in the same position in the title block as the 
date supplied by VHATE code. This is the third line of 
the ti tl e bl»ock. 



60460290 01 



3-17 

CDC - SOFTWARE ENGINEERING SERVICES 

13 DEC 83 
TXTfORW 1.5 Reference Manual REVi 1 

3*0 FORMATTING CODES 

3.1*3 UNDERLINING* BOLDFACE- AND BLANK CODES 

3.1.3 UNDERLINING* 30LDFACF AND BLANK CODIES 



\8LANKnnn 

Maa&&-l£-.l£l£ 

nnn number of blanks will be Inserted as text in the 
current position of the document* If nnn is not 
specified* 1 will be used* 

\SOLO 

The text following the BOLD code* until the occurrence 
of the \80FF> code* Hill appear In boldface* achieved by 
overprinting each character with itself* Boldface text 
can also be UQdfttllQfill* 

\BQFF 

£&l££a££-X£2L.0££ 

The \BQFF code tern? nates the \BOLD code* 
MINDER 

Uad££lia£ 

Characters in the formatted text following this code 
will be underlined.' Underlining will be terminated 
upon the occurrence of the \UOFF formatting code* 

\UOFF 

yad££liaiaaJ2££ 

This code terminates underlining initiated by the 
\UNDER code* 

The underline character can be input as text from a terminal 
when the ASCII and T£RN*713 command are in effect* 

In cases where the underline character itself is desired as a 
character representation and cannot be input directly! or where 
repetition of entry Is undesirable* the \BLANK code can be used 
with the VUNDER code* For example* 

\UNDER 

\BLANK30 

\UQFF 

4 oul d produce "_, • 



60460290 01 



3-18 

COC - SOFTWARE ENGINEERING SS*VtCES 

13 9£C 83 
TXTFORH 1.5 Reference Hanya! RcVt 1 

3.0 FORMATTING COOES 

3.1.3 UNDERLINING* BOLDFACE AND BLANK COOES 

In using the \UNDS* and VsniD codes to emphasize text* a space 
must be provided by the user In the source text If a space is 
intended to appear between the emphasize*! text and surrounding 
text in the formatted line* 

This requirement occurs in two unique sequences in the source 
text. 

1. In selecting VJNfJf=P and/or \BQL0> if the text to be 
emphasized Is to aopear as* 

nerd fefiain-u'adatilaJUaa: 

the source sequence should be 

word 
\ under 
beg in under I Ini oq 

* Note the space prior to the b. 

2« In terminating emphasized text with VBOFF and/or 
\U0FF* text that is to appear as* 

boldface text completed 

the source sequence should he 

boldface text 
\hoff 
compl eted 

* Note the space prior to the c. 
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3 • 2 d£4mg& J»£K£L-S£L££Iia2L.I& ill 







* 






t 

* 


LINES 


• 
* 


LINES 






t 
* 












new ? 


ALL 


f 
t 


SPACED? 


SPACEDI 


UNDER 


• 
1 


INDENTS 








PAS? ! 


CA*S 


• 

# 

• 

* 


AFTER 


1 

fl 

« 
f 


BEFORE! 


LINED 


4 

9 

* 
• 


SPACES', 


f \H1(\H11) 


SECTION 




















t LEVEL 1 






x- \ 


X 


I 


5 


• 
• 






X 


J 






S\H2(\H12) 


SECTION 








• 




1 

4 








* 

* 






ILEVEL 2 










* 

1 




• 
1 
















VHEADA 






X 


• 
* 


1 


i 
t 


2 




X 










VHEADB 






X 


1 

t 


2 


* 
t 


3 




X 










VHEADC 




1 

* 


X 


• 

f 


1 


« 
i 


Z 




X 








!\H3CVH13> 


SECTION 








t 

■1 


















? LEVEL 3 


VHEADA 
\HEADB 






X 
X 


• 

* 
1 

t 
1 


1 

z 




2 

3 














VHEADC 




* 


X 


• 


1 




Z 












{ VH4(VH14! 


SECTION 








1 


















REVEL 4 


VHEADA 
XHSAOB 
VH€ADC 








* 

* 

* 
1 

• 

• 

t 


1 
z 
1 




I 
3 
2 




X 
X 
X 








!\H5f\H15) 


SECTION 








I 
1 


















'.LEVEL 5 


VHEADA 
VHEA08 






X 
X 


• 

» 

1 

» 

1 






1 
1 




X 










\HEADC 






X 


1 






1 


J 


X 








i VH6CVH16) 


SECTION 


























JLEVEL 6 


\HEADA 
VHEADB 














1 




X 
X 










VHEADC 






X 




















S\H7(\H17! 


SECTION 


























S LEVEL 7 


VHEADC 














1 




X 








JVP PARAGRAPH CONTROL 


























VHEADA 














1 








3 






VHEADB 














1 








3 






VHEADC 














1 








5 





60460290 01 



3-20 
COC - SOFTWARE ENGINEERING SERVICES 

13 DEC 83 
TXTFQR.H 1.5 Reference Manual REVi 1 
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3.3 SUMMARY C1F FORMATTING : : HOES 

3 . 3 sujm&i JiE-EQ&aAiLiiis-aaaK 

The following Is a short list of the Formatting Codes as they 
Hould appear In use. Those codes that exoect subsequent text are 
so noted. 

\A 4s Is 

Text 

\8xx»y.y#«««z:? Begin box 

X98xx#yy#«««zz Enlarge box 

\C Center 

Text 

XE End box 

\F 3eg1n footnote 

Text 

XGxx# yyf • • • zj Horizontal line 

Heading level selection 

Indent 

Hanging Indent 

Keeu 

Box I I ne 

Margin note 
Na*p page 
Overor Int 

Paragraph 

End vert I cal I Ines 
Release keep 
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VHnn 


Text 


XInn 


Text 


XJnn 


Text 


XKnn 


Text 


XL 


XM 


XNnnn 


XO 


XP 


Text 


XQ 


XR 
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\$nn SMo 

\Tnn *ab 
Text 

\«Tnn Pad and tab 
Text 

\U Untab 

Wxx# yy* •• *zz Vertical'- lines 

\VVxx*yy»««*zz *dd vertical lines 

\Xn Excaotion 
Text 

VZ End footnote 

\ ^lul I formatting code 

\8LANKnnn Insert blanks as text 

\80FF boldface off 

\B1LD Boldface 
Text 

\CHANG£#ccccccc Change (revision) bars 

VCOOES Codes/Error list generated 

XCOMMitMT Commented source file 
Text 

\0ATE n«te 
Text 

VFOIIO Folio line 
Text 

\FORHATaa>bb*nn Page for»n margin* length* depth 

\HJEADc Heading style 

\JUST Justification on 

\LENGTHxxx «*rlnt line length of text body 

\LISTn#n# .»nn Supplemental list 
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Text 

XtARGINnn Left margin of text body 

XNOJUST Justification off 

XNOSEQ Mon-seouenced formatted file 

XRECQRDxxxjpzz* Input record field delimiters 

\S£CTIONnnn*nnn*tf nnn Partial listing by section 

XSETAPP 

c-xxxxxxx Set Appendix 

XSETE#c Set code delimiter 

XSEQ Sequenced formatted file 

XSETSECnnn Set Section Number 

XSETTA8nnxx>nnyy#nnzz Set tabs 

XSPACEn Line spacing 

XTITLEn Select title line 
Text 

XTODAY Toiays late 

XUNDER Underline 
Text 

XUOFF Under! ining off 
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4.0 ca8mims.A!ifi-a£Ei!iiiia!f5 

4.1 £OM^£MI10M^ 
£aa£_£fi£ia£ 

The allocation of space on a oage for the placement of text 

defines the format of * page* The formatter views a page as 
containing two text types* 

l) Designation Text — Text of this type in some way 
identifies or' describes a relationship of text from page 
to page* Included in this type aret 

Sequence numbers 

Date 

Rage numbers 

and the text associated with 

Title -and sub-title block 
Folio line 
Supplemental lists. 

Z) Text body - The body is the principal text of the 
document* exclusive of designation text. All the 
formatting codes* except those relating to designation 
text* affect the text body. 

The program places the title blocks* if present* at the top of 
the form and the folio fine as the iast line of the form. The 
user may adjust the placement o* 8 designation text with the FORMAT 
code. 

In preparing the title block* the program wi) I provide a 
format containing the following information! 

A title block of one to six title lines* each fine chosen by 
the user with the \TITlEn formatting code. 

A sub-title block consists of 5 lines* the first Is a hyphen 
line followed by two lines Indicating the major and 
minor section levels of text in effect at the beginning 
of the current oage* followed by another hyphen line 
and a blank line. The major section level Is the 
current \Hl code selection in effect* the minor section 
Is the \H2-\H? code }n effect. The sub-title blocti 
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will not wpz&r If no \H1~\H7 codes have been used. 

Current date unless \DATE code Mas used to select another. 

Page number *hich Is the current major section number and 
sequential ©aoe within that section or a numerically 
sequential number If no section numbering Is In effect. 

If less than the maximum number of title lines available Is 
selected* those in use will be compressed to provide a compact 
title block. An example of tbe title block ls« 



TITLE! Text 
TITLE? Text 

TITLEn Text 



PAGE 1-1 

MH/oo/yy 



s.0 Heading 

s. I —Head! no 



(blank line) 

Section numbering bv the formatter is Introduced through the 
use of the beading level selection codest \H1-\H7. The text 
associated with these codes* together with the appropriate 
section number generated by the program* becomes part of the 
formatted text. 

Automatic section numbering will be based on the occurrence of 
the heading selection codes* \H1-\H7. 

Sections are numbered and incremented by tbe occurrence of HI 
codes. The text lines associated with successive \H1 codes* for 
example* will be prefixed by the section numbers 1.0* 2.O**»*s.0. 

The first occurrence of Bnvf \H2— \M7 heading code Mill cause 
that section level number to be 1. Each subsequent occurrence 
will increment that level number by one. Section level numbers 
Mill return to when a new section Is started by the next \HI 
heading code. The hierarchical sequence is as follows! 

\H1 s.0 

\HZ s.l 

\H3 s.l.l 

YH4 s.l. I. I 
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4.1 CONVENTIONS 



\H7 



S • ! • I • 1 • i 
S.f .1 . I.I.I 

s. i • i • i . i * i • i 



The range of the section number Is) and the section level 
numbers U) is 1-999.? It should he noted that the section level 
numbers should he counted as text characters when It cones to 
determining the length of the formatted text line. 

The user may wish to arrange a document that makes use of the 
automatic section numbering feature but still allow portions of 
the text to be headed and Included in supplemental lists without 
appended section numbers. 

In the description of the heading level selection codes* 
\H1-\H7* the n value of 1-? corresponds to the level of section 
number requested for the subsequent text. The appropriate 
section number Mill be determined by the program nnd prefixed to 

the heading text supoliled by the user* 

As seen in the Heading Leva! Selection Table* the \Hnn codes* 
together with the \H5ADc code* oroyide a variety of format style. 

In order to allow the same stvle headings as described for 

\H1-\H7* a subset of selection codes* \H11-\H17 will provide the 

same format style as Its H1-H7 counterpart but will not be 
prefixed by section numbers.' 

If a user wishes to produce a document without any program 
qenerated section numbers* the \H11-\H17 should be used 
exci us I vel y. 

Therefore* a text file that contains the XHnn codes will 
produce a document with the following characteristics* 

\H1-\H7 codes control automatic section numbering and 
partial listing by section requests. 

If a level number is missing from the sequence \H2-VH7* the 

section number generated for that level will be xeroi 

I.e.; 1.1.0.1.1. Indicates no \H3 heading was 
selected. 

If no \H1 occurs in the text but subsequent \H2-\H7 codes 
do* the entire document will be treated as Section 1.0 
and the page numbers will be l-nnn. If the VSETSECnnn 
code has been invoked* the section number supplied is 
nnn .0. 

The first occurrence of an VH1 code starts the page 
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4.1 CONVENTIONS 



numbering at s-o even if \H1X-\H17 headings have 
appeared earl I er In the text. Page numbers *f M I remain 
in the form s-« throughout the document* where s Is the 
section nusber an* p is the page within the section* 
Page numbering will be non-sectioned until the 
occurrence of the first VHn code. 

If no \H1-\H7 codes are used* no automatic section numbering 
takes place and no sub-title block Is produced. 

It is possible to request a listing of sections of a document 
rather than the entire document. The sections that ^tb requested 
to be printed appear as parameters on the \SECTI0N formatting 
code. Only sections that are created through the use of \H1-\H7 
heading codes or supplied by the VSETSEC code pay be referenced 
bv the \SHCTIQN code. 

The strinq of section numbers requested to be printed should 
reflect the section numbers as they will appear in the formatted 
document. The smallest unit of text that can be requested for a 
partial listing is a section. The section numbers refer to the 
(si portion of the s.3 numbers that have been generated for the 
document by the program. 

+•2 flEEiaillflHS 

The formatter recognises a word as a contiguous string of 
ASCII graphic characters. 

£3£&I£i££& 

Those formatting codas that have optional or required 
parameters are designated *ith one of the following suffixes. 
The parameter notation *1I'I indicate the maximum range allowed 
for that parameter tyoe. ^or example* an nn parameter implies 
that the value of the parameter could be 1 through 99. A 
character position parameter of aa would accept positions 1 
through 99. Codes that require leading zeros on numeric 
parameters less than 10 will specifiy this in the code 
description. These parameter notations are defined as foil oust 

aa* bbt xx*yy*zz 

xxx*yyy* zz* Indicates numeric character positions. 

n A numeric count of character positions or 

number of lines* or a designation 
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of type such as heading selection* 
n has a value of 1-9. nn would 
represent 1-99, nnn is 1-999. 

c An ASCII character Is requested as a 

parameter • 

text In some cases* text can be considered a 

parameter as In the heading and 
date selection codes. 

An end of sentence Is defined as a period followed by one or 
more blanks! also when a period* exclamation point or question 
mnrk is followed immediately by one or more close parenthesis 
and/or quote and then a space. The program will format a minimum 
of 2 blanks between sentences. Other blanks may be inserted 
during the justification process. 

E££a£-£££&a££S 

The program produces the following error messages which are 
appended to the formatted file. 



The page and line number where the error occurred will 
Mill appear on the same line as the message. 

Column xxx overlaid 

User requested more than one character Placed 

In a character position by soma means other 

than oyer or in ting* 

Line overflowed 

Formatting codes In effect produced a 
formatted text line longer than the specified 
line limit. 

Sox append but no previous box code 

A \S1 code was encountered without having a 8 
code precedelng It to define the original 
si*e of the box. 

SETTAB error 

Faulty tab setting parameter. 

Word count error 

passage generated when the justification 
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process qoes awry* 

Unrecognized formatting code 

The character string following the formatting 
code del Niter is not valid. 

In the case of oar ameter's that exceed the designated value 
i i m i tati ons# the program wlM* substitute the iast correct value 
set for that code. 

The following selection of Page dimensions will be considered 
the default conditions. These are assembly-time values of the 
SES Text Formatter prtmr^m* TXTPQRN. 



\HARGIN 
UENGTH 

\REC0R0 

\ SPACE 

\JUST 

\H€AD 

XNOSEQ 

\FORHAT 

\T0DAY 

\SETTAB 



10 

15 

effective line length (\LENGTH-\^ARGIN) 

Character positions 1-136 of input record 

Sinqie spacing 

Justification on 

Style A 

Mon-Seouenced document 

Page form margin 7§ length 15* depth 60 

Todays date 

10*5, £10t315t420# 525* 630t7B5» 840*9 45, 

1090tll55>1260» 1365* 1*70*1575 
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£alyiajL.Is&t 



.-4. 



COLUMNS 



1 EXAMPLE 



It is 

col u*nna 
tabbing 
codes, 
begins 
jus tiff 
col uam 
these c 

\HargH 
\Length 
produci 
wi de 
dimensi 
def Inln 
1 abel 
offset 



possible to produce 
r text with the 
» margin and length 
Since flowing text 
at the margin and is 
ed as to length* a 



can 

o d e s • : 



be defined with 



30 

m 

ng a twenty character 
column. The box 

ons are 15* 28* 65. By 
o a tab setting* a 
or other text can be 
from this co luran. 



LABEL 



+•_•.._ .—. .-, 



8y switching 


the 


column assignmen 


ts# 


the fields can 


be 


reversed* Har 


gi n 


i s now 17* 1 en 


9th 


is 36 and the 


box 


dimensions are 


set 


at at 15*40* 


and 


65* The box 


is 


completed with 


the 


\e code* 





EXAMPLE 



+- — .-., — — --——>,™ .-.—.——. ™ — •..••..••4. 
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5»0 SXAH^LES 



Another example of the use of box and line codes demonstrates 
the ability to produce ff : o* II eqraw-type figures* 

The first sequence of codes produced the ensuing box* 



\B30#45 

\s5 

Ve 






»-+ 



To Insert text In the box* the sequence becomes* 
\b30#45 
Ns2 
\ i 17 Margin **as set at 15 (tabblnq could also be used) 

TEXT 

\s2 

\e 
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To add connecting lines* the horizontal 
drawing codes can be used* 



and vertical I ine 



\v3? 

\s4 

\o 

\b30#*5 

\sZ 

\I1? 

T e x T 

\9l5»30;*5»50 

\v50 

\s3 

\e 

\s6 

\Q 

\i>42*58 

\s5 

\e 



end this vertical oiece 



start horizontal 
start vertical 



The figure produced is? 



TEXT 



.— ♦ 



+-. 






+-« 
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5.0 SXAHPLES 



IakUi!£-Xt£2£ 



To produce a table of I tens* tfce tabbing features can be used* 
In the Following examHe»"the tabs are sett 

\satfrab720#828*9SOilQS>0 

By yslng the \T and tne \»T codes with tne appropriate tab 

setting number a table Is oroduced. An example of one line of 

the I I st woul d be* 

\t7 

One 

U8 

Pool table 

\*t9 

> green 

One Pool Tabl* •«..•••••••> green 

Ten Cues .«•••••••••••••••> numbered 

Rack Sails ••••••••••••••••> colored 



Tne code V.tlO Produced the dotted lines* 
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5.0 EXAMPLES 



The footnote featur'e allocs references from within a portion 
of text to post-script text at the bottom of the page. It is 
important to remember that the calling out of the footnote text 
must occur at the position in the text stream that the footnote 
symbol appears* This is the only way the program can assure that 
the footnote text will aooaar on the same page as the reference 
symbol • 

The footnote appearing on this page and the text containing 
the reference to it was Input as follows! 

\p 

Saint-Exupery on huaan relations* 'We forget that there Is no 

hooe of joy except In husaan relations* 1 *** 

\F 

*** Also? •Happiness! It is useless to seek It elsewhere than in 

this warmth of human relations. Our sordid interests imprison us 

within their walls. Inly a comrade can grasp us by the hand and 

haul us free.* 

\? 

from the book *w"ind» Sand and Stars'. 

As it would* then* apoear In the document* 



Sai nt-Exupery on human relations* f ye forget that there is no 
hope of joy except in human relations* • *** from the book 'Wind* 
Sand and Stars'. 



*** Also? 'Happiness! It is useless to seek it elsewhere than in 
this warmth of human relations. Our sordid interests imprison us 
within their walls. Inly a comrade can grasp us by the hand anl 
haul us free*' 
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5.0 EXAMPLES 



The formatter ignores extraneous blanks In the text stream. 
Therefore* it becomes necessary to use other weans to Introduce 
more than one blank into the formatted text* 

This can be done io several ways* 

1) The \A code* as—Is* does not interpret the text it 
references but rather allows the user to place the text 
data in the input record in the format desired for that 
print line. Blanks* therefore* are not ignored but 
printed as encountered. 

2) The \8LANKnnn code requests the formatter to insert nnn 
blanks into the current position in the formatted text. 

31 The following codes will not have extraneous blanks 
removed fro* the associated text? therefore blanks Mill 
be considered as part of the texts 

MIST 

\F0LIO 

\TITLS 

\X (exception) 

\H (heading) 

\C (centered text) 

A table of contents can be produced by using the MIST code. 
(See the definition of MIST). The text following the \LIST code 
can be f Table of Contents' or any descriptive statement. The 
list produced will be printed following the document. Each 
supplemental list requested will be numbered consecutively by 
page 1* 2 * * # n . 
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6.0 USING THE FORMATTER UNDER MQS 



6.0 UiUifiJLa£-£fl&iiAIIEli-U!iQEa-llQS 



The source file of text and formatting codes is created unde*' 
HQS in ASCII node* 

Conversion programs are available that Mill convert the 
formatter ASCII output file to a HOS 6/12 file for display on a 
terminal or orinting. 

These conversions are available with the UTL utility described 
in the SES Users Handbook, 

A formatted document cai be obtained by using the utilities 
and NOS commands described in the SES Text Formatter material in 
the SES Users Handbook. 

6.1 ££flil£Ba£Q.SQURC£.£ILK-A!ia-10IS£a-Qflr*yfl£aIS 

The facility also provides for the generation of a document 
** i t h revision bars. Two source files must be provided! a base 
file containing the orlofnal (base! text and a change file which 
contains the original text edited with the desired changes. The 
files are compared and a revision file is generated that contains 
the appropriate source file identifiers. The necessary \REC0R0 
and \CHANGE codes are Inserted in the revision file and a 
formatted document is produced with revision bars marking the 
changed text. This feature Is described In the Utilities section 
of the SIRS Users Handbook. 
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